Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working with Movie Time

SetMovieTimeValue

The SetMovieTimeValue function allows your application to set a movie's time value. You specify the new time as a time value, rather than in a time structure. You must ensure that the time value is in the movie's time scale.

pascal void SetMovieTimeValue (Movie theMovie, TimeValue newTime);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

newTime

Specifies the movie's new time value. The Movie Toolbox interprets this time value relative to the movie's time scale. If you specify a value that is outside the duration of the movie, the Movie Toolbox sets the movie time to the beginning or end of the movie, as appropriate.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can also set a movie's current time by calling the SetMovieTime function, which is described in the next section. This function requires that you specify the new time value in a time structure.